Skip to content

Add in-docs web parser page powered by browser WASM#697

Open
1technophile wants to merge 1 commit into
developmentfrom
add-web-parser-page
Open

Add in-docs web parser page powered by browser WASM#697
1technophile wants to merge 1 commit into
developmentfrom
add-web-parser-page

Conversation

@1technophile
Copy link
Copy Markdown
Member

@1technophile 1technophile commented May 17, 2026

Description:

Adds a /parser page on the VitePress site that decodes BLE advertisements locally in the browser via a new BUILD_WASM_WEB Emscripten target (ENVIRONMENT=web,worker, EXPORT_ES6, SINGLE_FILE), built fresh by the docs publish workflow on each release. The Node.js WASM build shipped to npm is untouched.

Checklist:

  • The pull request is done against the latest development branch
  • Only one feature/fix was added per PR and the code change compiles without warnings
  • I accept the DCO.

@1technophile @claude
Add in-docs web parser page powered by browser WASM
88687fe 
Adds a /parser page on the VitePress site that decodes BLE
advertisements locally in the browser via a new BUILD_WASM_WEB
Emscripten target (ENVIRONMENT=web,worker, EXPORT_ES6, SINGLE_FILE),
built fresh by the docs publish workflow on each release. The Node.js
WASM build shipped to npm is untouched.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@1technophile
Copy link
Copy Markdown
Member Author

1technophile commented May 17, 2026

@mhaberler feel free to share your comments

@mhaberler
Copy link
Copy Markdown
Contributor

mhaberler commented May 17, 2026 •
edited
Loading

how can I preview this?
lost in build land :-/

ping @1technophile

@1technophile
Copy link
Copy Markdown
Member Author

1technophile commented May 24, 2026

Try this @mhaberler :

  1. Get Emscripten on your PATH (CI uses 3.1.61, any recent emsdk works):
    git clone https://github.com/emscripten-core/emsdk.git
    cd emsdk && ./emsdk install 3.1.61 && ./emsdk activate 3.1.61
    source ./emsdk_env.sh # puts emcmake/emmake on PATH

  2. Build the browser WASM (from the repo root):
    cd nodejs/theengs-decoder
    npm install
    npm run build:web
    That runs emcmake cmake -DBUILD_WASM_WEB=ON + emmake make, then copies the single-file ES6 module into
    docs/.vitepress/public/wasm/theengs_decoder_web.js.

  3. Run the docs site (from the repo root):
    npm install
    npm run docs:dev
    Then open the /parser page — it should load the decoder and decode the sample payload.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@1technophile @mhaberler